home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / btrieve / bdebug.arc / BDEBUG.DOC < prev   
Text File  |  1988-09-04  |  3KB  |  90 lines
  1.  
  2. Bdebug - Debugging tool for btrieve user.
  3.  
  4. Bdebug is a debugging tool designed to help programmers which are using the 
  5. Btrieve record manager. 
  6.  
  7. Bdebug is a memory resident program which trace each call to Btrieve and
  8. display all parameters sending to and receiving from Btrieve.
  9.  
  10. Having the ability to watch each parameter sending to or from Btrieve
  11. mean a lot of time saving and more convenient way to trace error in program.
  12.  
  13. To activate the program just type bdebug. Note however that this program
  14. must be loaded AFTER the Btrieve record manager.
  15.  
  16. Once loaded, the program is in a sleeping mode. to activate the program one
  17. must press the ALT CTRL LEFT-SHIFT keys all together.
  18.  
  19. When activated, Bdebug display its menu which contain 6 options.
  20.  
  21. Use the arrow keys to move the lighted bar between options. Select option by
  22. pressing the enter key.
  23.  
  24. The option that appear in the menu are.
  25.  
  26. 1. Sleep/wake up.
  27. 2. Window position.
  28. 3. Window size.
  29. 4. Single/Double strike.
  30. 5. Unhook Bdebug.
  31. 6. Exit this menu.
  32.  
  33. 1. Sleep/wake up.
  34.  
  35. Once loaded, the program is in sleep mode. In order to begin tracing of
  36. Btrieve call, press the key combination to activate the menu, than select
  37. the first option and press ENTER. The first paragraph will change from 'sleep'
  38. to 'wake up'. From now on Bdebug will trace Each call to Btrieve and will
  39. display the parameters in special window on screen.
  40.  
  41. After putting the program in the wake up mode, select option 6 to exit
  42. menu and resume normal program execution. Note however that it is also
  43. possible to quit the menu any time by pressing the ESC key.
  44.  
  45.  
  46.  
  47.  
  48. 2. Window position.
  49.  
  50. By selecting this option, the user have the ability to place the window at
  51. any chosen location on the screen. After selecting this option, the menu
  52. will disappear from screen and the data window will be shown. Use arrow keys
  53. to bring this window to desired place, than press ENTER or ESC keys to 
  54. return to menu.
  55.  
  56. 3. Window size.
  57.  
  58. By enlarging window size, The user have the ability to examine the content of
  59. the key and the record. those are given both in ascii and hex format.
  60. Again, use arrow keys to enlarge the window size. When done, press ENTER or
  61. the ESC keys to return to menu.
  62.  
  63. 4. Single/Double strike.
  64.  
  65. Usually, the Bdebug program will display all parameters which are sent and
  66. receive from Btrieve in a window, Than it will wait for key to be pressed in
  67. order to resume execution. Actually the program display all parameters twice.
  68. Once before calling Btrieve and once after the call.
  69. Sometimes it is desirable to examine parameters before AND after the call.
  70. If this the case, choose this option and by pressing enter change it from
  71. single to double strike. The program will wait for user input before it call
  72. the Btrieve and after returning.
  73.  
  74. 5. Unhook Bdebug.
  75.  
  76. select this option to remove Bdebug program entirely from memory.
  77.  
  78. Warning - NEVER uninstall the program while you are running another program.
  79. always choose this option from DOS prompt only.
  80.  
  81. NEVER uninstall the program if there are other memory resident programs
  82. above it. Uninstall them first.
  83.  
  84. Hope you benefit something by using this program
  85.  
  86.  
  87.                                        Jacob Gafny.
  88.                                    Israel 1987.
  89.  
  90.